<?php
/**
 * 版本信息管理类
 * 
 * @author jlpay-sdk-php
 * @version 1.0.2
 */

namespace JLPay\Core;

/**
 * SDK版本信息类
 */
class Version
{
    /**
     * SDK版本号
     */
    const VERSION = '1.0.2';
    
    /**
     * SDK名称
     */
    const NAME = 'JLPay PHP SDK';
    
    /**
     * 发布日期
     */
    const RELEASE_DATE = '2025-08-04';
    
    /**
     * 获取完整的版本信息
     *
     * @return array 版本信息数组
     */
    public static function getVersionInfo(): array
    {
        return [
            'name' => self::NAME,
            'version' => self::VERSION,
            'release_date' => self::RELEASE_DATE,
            'php_version' => PHP_VERSION,
            'full_name' => self::NAME . ' v' . self::VERSION
        ];
    }
    
    /**
     * 获取版本号
     *
     * @return string 版本号
     */
    public static function getVersion(): string
    {
        return self::VERSION;
    }
    
    /**
     * 获取完整版本字符串
     *
     * @return string 完整版本字符串
     */
    public static function getFullVersion(): string
    {
        return self::NAME . ' v' . self::VERSION . ' (' . self::RELEASE_DATE . ')';
    }
    
    /**
     * 获取用户代理字符串
     *
     * @return string 用户代理字符串
     */
    public static function getUserAgent(): string
    {
        return self::NAME . '/' . self::VERSION . ' (PHP/' . PHP_VERSION . ')';
    }
} 